CSX Server Logging On
This page provides a quick step by step walkthrough of getting logged into your CSX server account for the first time. Following through with your own information is highly recommended. At the end of the session, you should be able to log into your account from both on and off campus, as well as transfer files and use the handin program. Suggestions for further elements are always welcome.
- Finding your Username
✓ Find and write down your username
-
If you haven't already activated your O-Key account, you need to do so before proceeding further. O-Key is the central authentication service operated by OSU's IT department and will be used in this session to identify yourself to the CS password reset application.
-
The same short usernames provided by O-Key are used on the Computer Science servers (CSX), so you won't need to remember a separate account name. However, it's important to understand the difference between the long and short account names.
-
-
Log into your O-Key account and review your Personal Profile.
-
Look under your name for an entry called "O-Key Account Username:" This is a short series of characters that you'll use to log in. It is usually formed from parts of your name to make it easier to remember.
-
Be aware that this short username is not the same as the "O-Key Login Address" further down the page, which is an email address containing your full name.
-
The short username should be no longer than 7 characters and does not include
@okstate.edu
or any other domain extension.
-
- Setting your Password
✓ How to setup/reset your CSX password
-
When your CSX account was created, the password was initially set to something long, random, and unknown to anyone. This ensures that unused accounts are not a security risk. However, this password isn't useful for accessing your account, and no one can unencrypt it to find out what it is.
-
You will need to reset your password before using your account. This procedure can also be used any time you forget your password.
What you will need:
→ Your short username from the previous step
→ Your O-Key password
-
Open the Password Reset page in any web browser (please avoid old versions of Internet Explorer).
-
You should see something that looks like this:
-
-
Type your short username from the previous step into the input field and click the Check UID button. This should expand the form to show a new field and button.
-
Next, enter your O-Key password and click the Check Password button. You can also press the ENTER key instead of clicking the buttons.
-
If you entered your password correctly, a grey box will appear, reminding you of what will happen after clicking the final button. Be sure to read this text, especially the first time you do this. At this point, the page should look similar to this:
-
When you're ready, click the Reset My CSX Password button. You will receive a randomly generated password. (Please copy it somewhere safe if you want to change in the following step).
-
If you don't want to use the generated password in the long-term, you can change it after logging into a CSX server:
- Follow the steps in Logging into a CSX Server , you need to login using the generated password you saved from the steps above.
- After you login, type
passwd
and press Enter. - Enter your current password (the generated password).
- Enter your new password.
- Retype your new password to confirm.
What if my username isn't recognized?
If you were enrolled in a Computer Science course only recently, your account may not have been created yet. Try again tomorrow! If a few days pass and it still hasn’t been created, contact the technical staff using the Support Request Form for assistance.
-
- Using the VPN (to Login from Off-Campus Network)
✓ How to install Cisco AnyConnect (if needed)
✓ How to connect to the campus VPN (if needed)
If you're only going to access the servers from the Stillwater campus, you can probably ignore this step entirely. But if you're ever going to connect from somewhere else, you'll need to use the university's Virtual Private Network. A VPN effectively makes your device part of the campus network, and thus able to "see" campus systems and not be blocked by firewalls that otherwise prevent unwanted visitors.
Logging into the CSX servers might require OSU's VPN in order to access them while connected to MyResNet Wi-Fi.
Installing OSU's VPN
Microsoft Windows, Apple Mac OS X/OS, and Linux
-
In Firefox or Chrome visit the OSU VPN (osuvpn.okstate.edu). Internet Explorer and Edge are not recommended.
-
Enter your O-Key Login Address and Password into the appropriate text boxes of the login portal.
-
Select the Login button.
-
Choose the Download button from the Download & Install page. The software download should process automatically.
-
Locate and open the AnyConnect file in your computer’s downloads folder.
-
Select the Next button from the Setup Wizard.
-
Accept the End-User License agreement by choosing the I accept radio button.
-
Select the Next button from the same window.
-
Choose the Install button from the Ready to Install window.
-
Select the Yes button from the User Account Control window.
-
Choose the Finish Setup Wizard button to complete the setup. Please see the Connecting to OSU's VPN section below for information on connecting to the OSU VPN.
Apple iPhone and iPad
-
Access the App Store icon from the display screen.
-
You will need to login using your App Store/iCloud credentials.
-
Search for Cisco AnyConnect.
-
For Apple iOS 10.0 or higher, select the Get located next to the Cisco AnyConnect heading. For Apple iOS lower than 10.0, select the Get located next to the Cisco Legacy AnyConnect heading.
-
Choose Install, which should replace Get.
-
A turning circle should replace Install.
-
Select Open, which should replace the turning circle when installation is complete.
-
Either an AnyConnect or Legacy AnyConnect shortcut will appear on your device display screen.
Google Android
-
Install Cisco AnyConnect from the Google Play Store.
-
Choose Accept when asked for access to device information.
-
An AnyConnect shortcut will appear to your device display screen.
Connecting to OSU's VPN
Microsoft Windows, Apple Mac OS X/OS, and Linux
-
Launch the Cisco AnyConnect program. In Windows click the Search button in the bottom left corner of the screen, and search for “Cisco AnyConnect”.
-
Type “osuvpn.okstate.edu” in the field, and click “Connect”.
-
Enter your O-Key credentials and click “OK.”
-
- Logging into a CSX Server
✓ How to login into the CSX server
All command-line logins to CSX must use the SSH protocol. Before April 2018, or on versions of Windows earlier than Windows 10, users needed third-party software like PuTTY. While you can still use PuTTY or similar programs, they are no longer covered here for simplicity.
-
Open a Command Line:
- On a Mac, open the Terminal app.
- On Windows 10, open either cmd or PowerShell.
-
Enter the SSH Command:
- Type the following, replacing "myusername" with your own username:
ssh myusername@csx2.cs.okstate.edu
- Type the following, replacing "myusername" with your own username:
-
Enter Your Password:
- When prompted, enter the CSX password you set earlier (not your OKEY password).
- For security, nothing will appear as you type. Press Enter when done. Your password will be accepted if it’s correct.
- Example;
-
Understanding Hostnames:
- The CSX system includes several servers you can log into. You can choose any of these, and they function similarly.
- Hosts starting with "csg" have added GPUs for GPU computing.
- The hosts are named as follows:
csx0.cs.okstate.edu
csx1.cs.okstate.edu
csx2.cs.okstate.edu
csx3.cs.okstate.edu
csx4.cs.okstate.edu
csg1.cs.okstate.edu
csg2.cs.okstate.edu
-
- Uploading Files: An Example
✓ How to upload files to CSX
Upload using SSH:
-
Open a Command Line:
- On a Mac, open the Terminal app.
- On Windows 10, open either cmd or PowerShell.
-
For uploading files, use one of two SSH-based transfer protocols SCP or SFTP:
- It doesn't matter which protocol you use, as both work effectively.
- There are many GUI clients available for multiple platforms that support one or both protocols.
-
Using SCP command:
- For example: If we want to copy a file name “myfile.txt” from local system to CSX:
scp myfile.txt pete@csx3.cs.okstate.edu:~/homework
In this example:
myfile.txt
is the filename.pete
is the username.csx3.cs.okstate.edu
is the hostname.~/homework
is the directory.
You could even use the
-r
option to recursively copy a directory. The-r
option in thescp
(Secure Copy) command stands for "recursive". When used, it tells the system to copy not just the specified directory, but also all of its contents, including subdirectories and the files within them, to the destination.For Example:
scp -r directory pete@csx3.cs.okstate.edu:~/homework
Upload using WinSCP (Windows Only):
WinSCP is a free application for Windows that can use the SCP and SFTP protocols.
-
Download WinSCP
- Go to https://winscp.net/eng/download.php and download/install WinSCP application.
- Go to https://winscp.net/eng/download.php and download/install WinSCP application.
-
Using SFTP or SCP on WinSCP application:
- Open WinSCP application.
- Select [File protocol], SCP or SFTP.
- Type the CSX hostname under [Host name:].
- Type your CSX username under [User name:].
- Type your CSX password under [Password:].
- Click Login then click Accept.
For example:
Creating a new site configuration. SFTP protocol has some advantages.Once you're connected using WinSCP, it's just drag and drop to transfer files.
- Local Side (Left Panel).
- Remote Side (Right Panel).
-
- Turning In Homework with handin
✓ Learn how to turn in homework with handin (if required)
While many CS classes use Canvas now, some still ask students to use
handin
, a venerable command line tool that the department has made available for over 25 years. It may seem a little unobvious at first glance, but it's actually pretty straightforward from the student end. First, a few things you'll need to have before running handin:- The files you wish to hand in already uploaded to CSX (see previous section "Uploading Files: An Example" for help)
- The name of the class account (for example, cs1113)
- The name of the assignment directory (for example, pgm1)
Here are a few examples of running handin using the above example names (note that these commands must be run on a CSX node):
handin
- Gives a very brief usage line
- --
handin cs1113
- Lists all of the available assignment directories for a class account
- --
handin cs1113 pgm1
- Lists all files you have already submitted in this directory
- --
In the example below, we are submitting an assignment file [myfile.txt] to course [cs1113] in the [pgm1] directory:
handin cs1113 pgm1 myfile.txt
- Submits the file and emails you a confirmation
You can list multiple filenames when submitting rather than have to run handin once for each file. As with many Linux commands, you can run
man handin
to see a description of the program.